home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 001-025 / disk_014 / shell / manual < prev    next >
Text File  |  1992-05-06  |  3KB  |  104 lines
  1.  
  2. YASO (yet another shell [something])  Manual, By Matthew Dillon
  3.  
  4. Terms:    You may not charge money or any form of service for use of
  5.     this program.  This program is public domain, and may be
  6.     distributed freely as long as The author's name (and your
  7.     name if you've hacked it majorly) and this message remains.
  8.  
  9. Startup:    sys:.login will be sourced by this program.  Usually, you
  10.         put general aliases there.
  11.  
  12.  
  13. The basic form of a command is:
  14.  
  15.     Command arg1 arg2.... argN
  16.  
  17.     * if the command is exactly a built in command, that built in
  18.         command is run.
  19.     * if the command is an alias, the alias is expanded 
  20.     * if the command is a partial of a built in command, that built in
  21.         command is run.
  22.     * otherwise, the command is Execute()'d
  23.  
  24. The line scanner will do various substitutions before passing the line to
  25. the command:
  26.  
  27.     Any set variables of the form $name is expanded to it's contents
  28.         % set abc hello
  29.         % echo $abc
  30.         hello
  31.  
  32.     Any file-path with wildcards (example: *.c), is expanded (a.c b.c ..)
  33.         % echo *.c
  34.         execom.c a.c x.c
  35.  
  36.     Within quotes, ^c is expanded to it's control character
  37.         % echo "^l"
  38.         < the screen is cleared >
  39.  
  40.     You may do history substitution of the form:
  41.         % !!                -previous command
  42.         % !partial            -search history for command
  43.         % !num                -a specific history #
  44.     
  45.     In most cases, you may use \ to overide a special character (there are
  46.     some bugs with this one)
  47.         % echo \*
  48.         *
  49.  
  50. INTERNAL COMMANDS
  51.  
  52.     quit                    -quit, done, vamoos
  53.     set    name arg1 arg23....        -set a variable ($substitution)
  54.     unset    name1 name2 ...            -unset variables
  55.     alias    name "command;command..."    -whatever you want to alias
  56.     unalias name1 name2 ...            -unalias aliases
  57.     echo    [-n] arg1 arg2...        -echo args to screen
  58.     source    file                -use a command file as input
  59.     mv    file1 file2            -rename a file (rename only)
  60.     cd    directory            -cd to a directory
  61.     rm    file1 file2...            -rm files
  62.     mkdir    dirname dirname...        -make directories
  63.     history                    -show history list
  64.     mem                    -show memory statistics
  65.     cat    file1 file2...            -simple file dump to screen
  66.     dir    dir/file dir/file..        -get directory
  67.     devinfo    [device]            -get device info 
  68.     foreach var ( arg arg arg ) command    -(see below)
  69.  
  70. VARIABLES:
  71.  
  72.     Two variables are reserved currently:
  73.  
  74.     _history                -# lines to remember
  75.     _prompt                    -command which causes your 
  76.                          prompt.
  77.  
  78.  
  79. SPECIFICS/SPECIAL COMMANDS:
  80.  
  81. echo [-n] arg ...
  82.     The -n option causes a newline NOT to be printed
  83.  
  84. foreach example: (assume the files a.c b.c c.c and d.c are in the curr. dir)
  85.     % foreach i ( *.c ) "echo -n hello;echo $i"
  86.     hello a.c
  87.     hello b.c
  88.     hello c.c
  89.     hello d.c
  90.     %
  91.  
  92. REDIRECTION:
  93.  
  94.     You may redirect only external commands (sorry).  Currently, the
  95. file name MUST BE NEXT TO THE '>' or '<'  '>charlie'.  However, the
  96. redirection args can be anywhere on the argument line.  The default
  97. redirection is to '*'.
  98.  
  99.  
  100.  
  101. BUGS:
  102.     An OS bug in Execute()... 30+ bytes are lost every time an external
  103. command is executed.
  104.